// =============================================================================
// | 包: conf                                                                 |
// | 模块: 七牛云配置                                                         |
// | 功能: 定义七牛云对象存储相关的配置结构体和字段                            |
// =============================================================================
package conf

// =============================================================================
// | 结构体: QiNiu                                                            |
// | 功能: 七牛云对象存储配置结构体                                            |
// | 用途: 存储七牛云对象存储所需的配置信息，用于初始化七牛云客户端            |
// | 映射: YAML配置文件中的qiNiu节点                                           |
// =============================================================================
type QiNiu struct {
	// =============================================================================
	// | 字段: Enable - bool                                                     |
	// | 功能: 是否启用七牛云存储                                                |
	// | 映射: YAML配置中的enable字段                                             |
	// =============================================================================
	Enable bool `yaml:"enable" json:"enable"` // 启用开关 - 是否启用七牛云存储
	
	// =============================================================================
	// | 字段: AccessKey - string                                                 |
	// | 功能: 七牛云访问密钥                                                    |
	// | 映射: YAML配置中的accessKey字段                                          |
	// =============================================================================
	AccessKey string `yaml:"accessKey" json:"accessKey"` // 访问密钥 - 七牛云API访问凭证
	
	// =============================================================================
	// | 字段: SecretKey - string                                                 |
	// | 功能: 七牛云密钥                                                        |
	// | 映射: YAML配置中的secretKey字段                                          |
	// =============================================================================
	SecretKey string `yaml:"secretKey" json:"secretKey"` // 密钥 - 七牛云API密钥
	
	// =============================================================================
	// | 字段: Bucket - string                                                    |
	// | 功能: 存储空间名称                                                      |
	// | 映射: YAML配置中的bucket字段                                             |
	// =============================================================================
	Bucket string `yaml:"bucket" json:"bucket"` // 存储空间 - 七牛云存储桶名称
	
	// =============================================================================
	// | 字段: Uri - string                                                       |
	// | 功能: 存储域名                                                           |
	// | 说明: 用于访问存储对象的CDN域名或存储空间域名                            |
	// | 映射: YAML配置中的uri字段                                                |
	// =============================================================================
	Uri string `yaml:"uri" json:"uri"` // 存储域名 - 访问存储对象的域名
	
	// =============================================================================
	// | 字段: Region - string                                                    |
	// | 功能: 存储区域                                                           |
	// | 说明: 七牛云存储空间所在的区域                                          |
	// | 映射: YAML配置中的region字段                                             |
	// =============================================================================
	Region string `yaml:"region" json:"region"` // 存储区域 - 存储空间所在区域
	
	// =============================================================================
	// | 字段: Prefix - string                                                    |
	// | 功能: 文件前缀                                                           |
	// | 说明: 上传文件时添加的前缀路径                                          |
	// | 映射: YAML配置中的prefix字段                                             |
	// =============================================================================
	Prefix string `yaml:"prefix" json:"prefix"` // 文件前缀 - 上传文件的前缀路径
	
	// =============================================================================
	// | 字段: Size - int                                                         |
	// | 功能: 文件大小限制                                                      |
	// | 单位: MB (兆字节)                                                       |
	// | 映射: YAML配置中的size字段                                               |
	// =============================================================================
	Size int `yaml:"size" json:"size"` // 文件大小限制 - 单位MB
}
